<?php
// $Id$

/**
 * Customer 封装来自 customer 数据表的记录及领域逻辑
 */
class Customer extends QDB_ActiveRecord_Abstract
{
    function web_site()
    {
        if ($this->web_site) {
            if (stripos($this->web_site, 'http') !== false) {
                $website = $this->web_site;
            } else {
                $website = 'http://' . $this->web_site;
            }
            return $website;
        } else {
            return '';
        }
    }

    function mailAddressItems()
    {
        return $this->mailAddresses->toHashMap('mail_address_id', 'address');
    }

    function bindMailPlan($mailPlanIds, $para = null)
    {
        if (isset($para['bind_to_mail_address_id'])) {
            $bind_to_mail_address_id = $para['bind_to_mail_address_id'];
        } else {
            $bind_to_mail_address_id = $this->default_mail_address_id;
        }

        $newMailPlans = array();
        foreach ($mailPlanIds as $mailPlanId) {
            $mailAddressPlan = new Mail_Address_Plan(array(
                                                          'customer_id' => $this->id(),
                                                          'mail_address_id' => $bind_to_mail_address_id,
                                                          'mail_plan_id' => $mailPlanId,
                                                          'status' => Mail_Address_Plan::PLAN_STATUS_PAUSED,
                                                          'mail_plan_id' => $mailPlanId,
                                                     ));

            try {
                $mailAddressPlan->save();
                $newMailPlans[] = $mailAddressPlan;
            } catch (QDB_ActiveRecord_ExpectsAssocPropException $e) {
                throw $e;
            } catch (Exception $e) {
                continue;
            }

        }
        return $newMailPlans;
    }

    function setDefaultMailAddress($address_id)
    {
        $this->default_mail_address_id = $address_id;
    }

    function addMailAddress($mailAddress)
    {
        $ma = new Mail_Address(array(
                                    'customer_id' => $this->id(),
                                    'address' => $mailAddress,
                                    'customer_name' => $this->nick_name,
                               ));

        $ma->save();

        return $ma;
    }

    function saveData($data)
    {
        $this->changeProps($data);
        $this->save();
    }

    static function findById($id)
    {
        return self::find('customer_id=?', $id);
    }

    /**
     * 返回对象的定义
     *
     * @static
     *
     * @return array
     */
    static function __define()
    {
        return array
        (
            // 指定该 ActiveRecord 要使用的行为插件
            'behaviors' => '',

            // 指定行为插件的配置
            'behaviors_settings' => array
            (
                # '插件名' => array('选项' => 设置),
            ),

            // 用什么数据表保存对象
            'table_name' => 'customer',

            // 指定数据表记录字段与对象属性之间的映射关系
            // 没有在此处指定的属性，QeePHP 会自动设置将属性映射为对象的可读写属性
            'props' => array
            (
                // 主键应该是只读，确保领域对象的“不变量”
                'customer_id' => array('readonly' => true),

                /**
                 *  可以在此添加其他属性的设置
                 */
                # 'other_prop' => array('readonly' => true),

                /**
                 * 添加对象间的关联
                 */
                'mailAddresses' => array('has_many' => 'Mail_Address', 'on_delete' => 'skip'),
                'mailAddressPlans' => array('has_many' => 'Mail_Address_Plan'),
                'waitingList' => array('has_many' => 'Mail_Waiting'),
                'country' => array('has_one' => 'Country', 'source_key' => 'country_id', 'target_key' => 'country_id', 'on_delete' => 'skip'),
                'profession' => array('has_one' => 'Profession', 'source_key' => 'profession_id', 'target_key' => 'profession_id', 'on_delete' => 'skip'),

            ),

            /**
             * 允许使用 mass-assignment 方式赋值的属性
             *
             * 如果指定了 attr_accessible，则忽略 attr_protected 的设置。
             */
            'attr_accessible' => '',

            /**
             * 拒绝使用 mass-assignment 方式赋值的属性
             */
            'attr_protected' => 'customer_id',

            /**
             * 指定在数据库中创建对象时，哪些属性的值不允许由外部提供
             *
             * 这里指定的属性会在创建记录时被过滤掉，从而让数据库自行填充值。
             */
            'create_reject' => '',

            /**
             * 指定更新数据库中的对象时，哪些属性的值不允许由外部提供
             */
            'update_reject' => '',

            /**
             * 指定在数据库中创建对象时，哪些属性的值由下面指定的内容进行覆盖
             *
             * 如果填充值为 self::AUTOFILL_TIMESTAMP 或 self::AUTOFILL_DATETIME，
             * 则会根据属性的类型来自动填充当前时间（整数或字符串）。
             *
             * 如果填充值为一个数组，则假定为 callback 方法。
             */
            'create_autofill' => array
            (
                # 属性名 => 填充值
                # 'is_locked' => 0,
            ),

            /**
             * 指定更新数据库中的对象时，哪些属性的值由下面指定的内容进行覆盖
             *
             * 填充值的指定规则同 create_autofill
             */
            'update_autofill' => array
            (
            ),

            /**
             * 在保存对象时，会按照下面指定的验证规则进行验证。验证失败会抛出异常。
             *
             * 除了在保存时自动验证，还可以通过对象的 ::meta()->validate() 方法对数组数据进行验证。
             *
             * 如果需要添加一个自定义验证，应该写成
             *
             * 'title' => array(
             *        array(array(__CLASS__, 'checkTitle'), '标题不能为空'),
             * )
             *
             * 然后在该类中添加 checkTitle() 方法。函数原型如下：
             *
             * static function checkTitle($title)
             *
             * 该方法返回 true 表示通过验证。
             */
            'validations' => array
            (
                'customer_num' => array
                (
                    array('max_length', 16, 'customer_num不能超过 16 个字符'),

                ),

                'full_name' => array
                (
                    array('max_length', 128, 'full_name不能超过 128 个字符'),

                ),

                'nick_name' => array
                (
                    array('max_length', 128, 'nick_name不能超过 128 个字符'),

                ),

                'country_id' => array
                (
                    array('is_int', 'country_id必须是一个整数'),

                ),

                'birth_date' => array
                (
                    array('skip_null'),
                    array('is_date', 'birth_date必须是一个有效的日期'),

                ),

                'web_site' => array
                (
                    array('max_length', 1024, 'web_site不能超过 1024 个字符'),

                ),

                'profession_id' => array
                (
                    array('is_int', 'profession_id必须是一个整数'),

                ),

                'grade' => array
                (
                    array('is_int', 'grade必须是一个整数'),

                ),

                'utc_offset' => array
                (
                    array('max_length', 16, 'utc_offset不能超过 16 个字符'),

                ),


            ),
        );
    }


/* ------------------ 以下是自动生成的代码，不能修改 ------------------ */

    /**
     * 开启一个查询，查找符合条件的对象或对象集合
     *
     * @static
     *
     * @return QDB_Select
     */
    static function find()
    {
        $args = func_get_args();
        return QDB_ActiveRecord_Meta::instance(__CLASS__)->findByArgs($args);
    }

    /**
     * 返回当前 ActiveRecord 类的元数据对象
     *
     * @static
     *
     * @return QDB_ActiveRecord_Meta
     */
    static function meta()
    {
        return QDB_ActiveRecord_Meta::instance(__CLASS__);
    }


/* ------------------ 以上是自动生成的代码，不能修改 ------------------ */

}

